View the changelog

Want to know the history of this service? View the change logs

Contact the author

Any questions? Feel free to contact the owners

Sends 2 messages

This service sends messages to downstream consumers

Receives 5 messages

This service receives messages from other services

Overview

The Basket Service is a domain-centric microservice within our bounded context that implements a gRPC-based API architecture to manage the transient state of customer shopping carts. This service encapsulates the complete lifecycle of a basket aggregate, from creation through modification to eventual checkout processing.

As a core part of our Domain-Driven Design implementation, the Basket Service maintains its own dedicated Redis persistence store, ensuring proper encapsulation of the basket domain model. It serves as the system of record for the shopping intent of customers before this intent is transformed into an order through domain events.

The service implements several key domain operations:

• Adding/removing items to the basket
• Updating quantities of basket items
• Managing the checkout process and transition to the Order bounded context

Following tactical DDD patterns, the basket is modeled as an aggregate root with basket items as entities within its boundary, ensuring consistency through transactional integrity and proper domain invariants.

Core Features

Feature	Description
Get Basket	Retrieves the current basket for an authenticated user, including all items and their quantities.
Add Item to Basket	Allows customers to add items to their basket, with validation ensuring quantities are greater than zero.
Remove Item from Basket	Enables customers to remove items from their basket, maintaining data consistency.
Update Item Quantity	Supports customers in updating the quantity of items in their basket, with built-in validation.

Architecture diagram

Messages for this service

Sends messages (2)

Quickly find the message you need by searching for the name, type, or summary.

Events (2)

Name	Version	Type	Summary
Deleted Basket Complete	v1.0.0	event	Represents a domain event that is published when reverse basket is completed
Deleted Basket Fail	v1.0.0	event	Represents a failed basket deletion event in the system

Receives messages (5)

Quickly find the message you need by searching for the name, type, or summary.

Events (1)Queries (1)Commands (3)

Name	Version	Type	Summary
Update Basket	v1.0.0	command	Update a basket
Delete Basket	v1.0.0	command	Delete a basket by its unique identifier
Create Basket	v1.0.0	command	Create a new basket for a user
Placed Order	v1.0.0	event	Receive a message when an order is placed

PreviousNext

Showing 1 to 4 of 5 results

Key Concepts

Infrastructure

The Basket Service is deployed as a containerized application within the BookWorm ecosystem. It leverages cloud-native technologies for scalability and resilience, ensuring high availability and fault tolerance.

The service is hosted on a cloud platform, utilizing Redis for high-performance data storage and container orchestration. This infrastructure setup enables seamless scaling and efficient resource utilization, supporting the dynamic demands of customer shopping activities.

Technical Implementation

The service is implemented in C# using:

• gRPC for high-performance API communication
• Redis for data persistence
• Domain-Driven Design patterns for business logic
• Built-in validation using Data Annotations
• Dependency injection for loose coupling
• Logging for observability and debugging